home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir34 / nbs_v102.zip / NBSDOCEN.DOC < prev    next >
Text File  |  1993-09-25  |  67KB  |  1,338 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ NBS       Norton Backup Shell                 │    D.I.S.P.     │────┐
  3. ║                                               │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 1.02                                │     ShareWare   │░░░░│
  8. ║ Rel.Date: September 25th,1993                 │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ NBS.EXE                                     |    └─────────────────┘
  12. ║ │                                             |       ┌─────┐        |
  13. ║ │                                             |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │                                             |     ┌────┴────┐      |
  16. ║ │                                             ------││││││ ═══│-------
  17. ║ │                                                   └─────────┘
  18. ║ │
  19. ║ │ Lines starting with '│' are
  20. ║ │ changes to NBS release 1.01
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28.  ┌───────┬─────────────────────────────────────────────────────────────┐
  29.  │   0   │ Table of contents                                           │
  30.  └───────┴─────────────────────────────────────────────────────────────┘
  31.  
  32.  1 ----    General information
  33.   1.1      Copyrights and License Agreement
  34.   1.2      Newer versions and contacting the author
  35.  
  36.  2 ----    Package description and requirements
  37.   2.1      Preface
  38.   2.2      Requirements
  39.   2.3      Included files
  40.  
  41.  
  42.  3 ----    Installation description
  43.   3.1      Installation
  44.   3.2      The configuration file(s)
  45.   3.3      INI options
  46.   3.3.1    [General] options
  47.   3.3.2    [Norton] options
  48.   3.3.3    [Cycle] options
  49.  
  50.  4 ----    Run-time information
  51.   4.1      Modes of operation
  52.     4.1.1  First time execution
  53.     4.1.2  Standard calls
  54.     4.1.3  Automated (scheduled) calls
  55.     4.1.4  Checking
  56.     4.1.5  Updating NBS.STA
  57.   4.2      Command-line parameters
  58. │ 4.3      Format of the NBS.ZIP file
  59.   4.4      Errors
  60.  
  61.  5 ----    Version information and credits
  62.   5.1      The BETA-team
  63.   5.2      Credits
  64.   5.3      Version history
  65.   5.4      Copyright, Trademarks
  66.  
  67.  ┌───────┬─────────────────────────────────────────────────────────────┐
  68.  │   1   │ General information                                         │
  69.  └───────┴─────────────────────────────────────────────────────────────┘
  70.  
  71.  1.1 Copyrights and License Agreement
  72.  ────────────────────────────────────
  73.  
  74.  - Users of the NBS-package must accept this disclaimer of warranty:
  75.  
  76.  - The  NBS-package  is  supplied  as  is.   The  author  disclaims  all
  77.    warranties, expressed or implied, including, without limitation,  the
  78.    warranties of merchantability  and of fitness  for any purpose.   The
  79.    author assumes  no liability  for damages,  direct or  consequential,
  80.    which may result from the use of the NBS-package;
  81.  
  82.  - The  NBS-package  is  a  "shareware  program"  and is provided at  no
  83.    charge to the user for evaluation.   Feel free to share it with  your
  84.    friends,  but  please  do  not  give  it  away  altered or as part of
  85.    another  system.   The  essence  of  "user-supported"  software is to
  86.    provide personal  computer users  with quality  software without high
  87.    prices, and yet to provide  incentive for programmers to continue  to
  88.    develop new products.
  89.  
  90.  - If  you find  this program  useful and  find that  you are  using and
  91.    continue the  use of  the NBS-package  after a  30 days trial period,
  92.    you must register the NBS-package as described below;
  93.  
  94.  - Non-commercial can get a license for the usage up to this release  of
  95.    the NBS-package for  a small amount  of money. Look  into the details
  96.    in  REGISTER.NBS.  Previous  registered  users  will  receive  a  big
  97.    reduction to upgrade to the  newer versions. These users should  look
  98.    into the details in UPGRADE.NBS.   For Non-commercial users there  is
  99.    a POSSIBILITY to submit to one of the special contracts as  explained
  100.    in the file REGISTER.NBS.
  101.  
  102.  - Commercial usage of  NBS will cost somewhat  more. Also, a so  called
  103.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  104.    direct to the  SysOp to get  full access) is  has to pay  more than a
  105.    Non-commercial  user.  Both  types  of  users  should  look  into the
  106.    details in REGISTER.NBS;
  107.  
  108.  - The registration of the NBS-package will license ONE copy for use  on
  109.    any computer at any  one time, as long  as the usage confirms  to the
  110.    type of registration you have done (so NON-commercial usage when  you
  111.    have a non-commercial license);
  112.  
  113.  - Anyone  distributing  the  NBS-package  for any kind of remuneration
  114.    must  first   contact  the   Author   at   the  address   above   for
  115.    authorization.
  116.  
  117.  - You are  encouraged  to  pass a copy   of the NBS-package  along   to
  118.    your friends  for  evaluation.   Please  encourage  them to  register
  119.    their copy if they find that they can use it;
  120.  
  121.  - Support  on  NBS,  when  used  in  a  non-commercial environment,  is
  122.    available  by  means  of  written  letters  or by entering the inter-
  123.    national echomail area DISP;
  124.  
  125.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  126.    conference <tm> called DISP (international). Entering this echo  does
  127.    not  exclude  you  of  the  duty  to register the NBS-package, though
  128.    users who evaluate the product can enter the echo for questions;
  129.  
  130.  - The  NBS-package, all  programs, the  documentation and support-files
  131.    is  copyrighted  1990,93  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  132.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  133.    this  package  for  backup  purposes.  Also  you  may  copy and share
  134.    unmodified copies of the whole package, providing that the  copyright
  135.    notice    is    reproduced    and    included    on    all    copies.
  136.    Excluded from this statement  are the support-files written  by other
  137.    authors.  Please  refer  to  the  documentation of these programs for
  138.    copyrights and license agreements;
  139.  
  140.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  141.    decompile  and/or  disassemble  the  software  in  the   NBS-package.
  142.    Patching the medium at  places that carry the  software is seen as  a
  143.    program change and is also forbidden. It is forbidden to create a  so
  144.    called 'bypass' to skip the original introduction screens and  delay.
  145.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  146.    author (Robert W. van Hoeven) himself;
  147.  
  148.  - Performing  any  of  the  illegal  actions as stated in the previous
  149.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  150.    important, to the registered users;
  151.  
  152.  - Bulletin Board  Systems that distribute  the NBS package  can convert
  153.    the WHOLE package  to any archive-system  they like but  all original
  154.    files must  be included  in the  new archive.  The NBS-package on the
  155.    Bulletin Board  can contain  at the  most 2  extra files. These files
  156.    can only be  a commercial for  that Bulletin Board  and/or validation
  157.    data that is presented  as a service to  all users and shall  have no
  158.    other functions;
  159.  
  160.  - After  the normal  trial period  of 30  days, you  must register  the
  161.    soft- ware (see REGISTER.NBS) or you must remove it from your PC;
  162.  
  163.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  164.    answered as soon I have the time  to do so. You can send me  a letter
  165.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  166.    point)  on  node  2:281/904  (RA  Support, Monster, Holland, SysOp is
  167.    Reinier de Groot).  When you want to send me normal mail, address  it
  168.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  169.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  170.    Echomail <tm> area;
  171.  
  172.  
  173.  1.2 Newer versions and contacting the author
  174.  ───────────────────────────────────────────────────────────────────────
  175.  The newest version of  NBS is always available  at the DISP-HQ on  node
  176.  2:281/904.  NBS  is  also  distributed  thru  a  number of DISP support
  177.  nodes and thru some forums in CompuServe. There are six   ways in which
  178.  you can obtain newer versions of NBS:
  179.  
  180.  - Logging on at DISP-HQ or a support node (FidoNet)
  181.    Look into the file SUPPORT.NBS for a full list of support nodes;
  182.  
  183.  - Logging on to a SDS node
  184.    NBS is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  185.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  186.    distribution point in Holland;
  187.  
  188.  - Logging on to your own BBS;
  189.    Chances  are,  that  you  will  find  an older version (international
  190.    users) because it will take some time for the new version to  'bleed'
  191.    thru the net;
  192.  
  193.  - Logging on to CompuServe;
  194.    Important versions of NBS are uploaded to several CompuServe  forums.
  195.    It is intended to upload  versions to the SYMANTEC and  IBMSYS forums
  196.    but depend on the authorization of  the forum sysops. If you are  not
  197.    sure, you can contact me on CompuServe personally;
  198.  
  199.  - Update service;
  200.    You can enter a special update service (read REGISTER.NBS).
  201.  
  202.  
  203.  If you think you have found problems in NBS, or in any other case,  you
  204.  wish to contact the author, you can send me:
  205.  
  206.  - A letter to the address you can find in the header of this file;
  207.  
  208.  - A  NetMail  <tm>  message  to   Rob Van.hoeven (please mind the point
  209.    between Van and Hoeven) at 2:281/904 or (better) 2:281/904.5;
  210.  
  211.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  212.  
  213.  - A  message  (mail  forum)  in  CompuServe to user Robert van  Hoeven,
  214.    with account/user number 100120,1146;
  215.  
  216.  ┌───────┬─────────────────────────────────────────────────────────────┐
  217.  │   2   │ Package description and requirements                        │
  218.  └───────┴─────────────────────────────────────────────────────────────┘
  219.  
  220.  2.1 Preface
  221.  ───────────────────────────────────────────────────────────────────────
  222.  In the many years I have worked with PCs, both professional as well  as
  223.  for  the  hobby,  I  have  used  backup programs to backup my important
  224.  files at least  a few times  in a week.  After I obtained  a tape-drive
  225.  for my own (home) system, I even backup on a day-to-day basis.
  226.  
  227.  In these years I  have used a large  number of backup programs,  all of
  228.  which I have bought  (one recovery of an  important file pays back  the
  229.  price of the single package  and more). All major backup  programs have
  230.  executed frequently over  here, until they  became too old  (and had to
  231.  be updated because of  f.i. a new DOS-version).  Then came the time  to
  232.  evaluate  the  marked  and  to  buy  a  new  version or swap to another
  233.  program.
  234.  
  235.  In recent years  I sticked to  Norton Backup, either  in the integrated
  236.  Norton DeskTop environment, in  the Norton DeskTop Windows  environment
  237.  or in  the DOS  (stand-alone) environment.  I always  had best  results
  238.  with the stand-alone versions, but this is personal.
  239.  
  240.  The current version of Norton Backup (2.2) is now currently being  used
  241.  for  a  number  of  months  (with  great pleasure and without any major
  242.  problems, which can't be said  of certain other backup programs  I used
  243.  in the past).  It is a  very versatile program  which maintains all  my
  244.  tapes, most  of them  with backups  of my  own work,  some of them with
  245.  complete projects (which have to be maintained for backward  reference)
  246.  and some with backups of the software I bought.
  247.  
  248.  But even  a program  like Norton  Backup <tm>  leaves some  whishes for
  249.  features. Some  of them  can be  emulated by  batch-files and  or other
  250.  macro-alike structures,  some of  them can't.  NBS was  written to be a
  251.  helpful  addition  to  the  current  Norton  Backup 2.2 (and even older
  252.  versions).  It  covers  a  number  of  'enhancements'.  This is done by
  253.  renaming NBACKUP.EXE to another name and to rename NBS.EXE to the  name
  254.  NBACKUP.EXE. Now, whenever you call  NBACKUP (either manually or in  an
  255.  automatic way, from  the NSCHED.COM scheduler  program), NBS is  called
  256.  which,  in  turn,  will  call  the  renamed  NBACKUP.EXE. Before Norton
  257.  Backup  is  called,  NBS  can  do  some pre-processing and after Norton
  258.  Backup has  finished, NBS  can do  some post-processing.  In fact,  NBS
  259.  (which stands for Norton Backup Shell) is an incorrect name. It is,  in
  260.  fact, some sort of front-end for Norton Backup.
  261.  
  262.  NBS covers the following 'problems':
  263.  
  264.  - Norton  Backup has  a habit  of creating  a number  of (more  or less
  265.    temporary) files  that can  be removed  after execution  but are  not
  266.    cleaned  automatically.  Examples  are  all  NBackup.* files that are
  267.    left in the data-directory, the RESTORE.TMP file and all *.BAK  files
  268.    which are created when  you update a SET.  NBS can remove these  (and
  269.    other) files, after Norton Backup has done it's job;
  270.  
  271.  - Norton  Backup generates  a lot  of files  in the data-directory (the
  272.    one pointed  to by  the NBACKUP  environment variable,  see the NB2.2
  273.    manual).  When  you  maintain  a  large  number  of  sets for various
  274.    reasons, the data-directory can be as big as 2 to 4 MB (depending  on
  275.    the cleaning you do). For each set  a SET, SAV, SLT and CAT file  and
  276.    depending on the type  of backup one or  more *.FUL, *.INC and  so on
  277.    files.  Most  of  the  time  you  only  need one set (with additional
  278.    files) at one time and most of  these files only stay on disk so  you
  279.    can restore with some ease. NBS  will collect ALL these files into  a
  280.    single PKWare ZIP archive (so they are compressed and it is one  file
  281.    and not tons of files) and will extract only the required files  from
  282.    this ZIP-archive before Norton Backup activates. In my  configuration
  283.    I reduced the overall HDU-consumption from 3 MB to 400K !
  284.  
  285.  - As time passes, your collection of SET/SAV/SLT/CAT and INC/FUL  files
  286.    will get mismatches when you  manually change files (delete, add)  or
  287.    when you don't want Norton  Backup to remove old catalog-files.  This
  288.    can be cleaned  by NBS. NBS  has a special  run-time option (/NBSCHK)
  289.    which will unpack  all SET/SAV/SLT/CAT/INC/FUL (and  remaining) files
  290.    from the archive and will check all files against others. It will  do
  291.    some suggestions what to do about orphan or missing files;
  292.  
  293.  - NBS can  be very helpful  when you work  with backup-cycles on  tape.
  294.    It is advised to use some  sort of scheme (see NB2.2 manual)  but one
  295.    of the  most schemes  gets some  help from  NBS. When  you start each
  296.    cycle (week,  twice a  week, month,  whatever) with  a full backup on
  297.    the tape and  will add (append)  the incremental backups  to the same
  298.    tape until the next cycle (in which cycle you use another tape),  NBS
  299.    is able to display the  tape-number/tape-letter that must be used  on
  300.    this cycle.  NBS will  increment the  number/letter when  a new  full
  301.    backup is detected  at the command-line  (/TF, see NB2.2  manual) for
  302.    the number of tapes you supply;
  303.  
  304.  - NBS  (for tape  users) can  be very  helpful to  determine the moment
  305.    when to clean the tape-drive. Usually you should clean your drive  on
  306.    a regular basis (like once every 8 productive hours). NBS will  count
  307.    the time  spend in  the actual  Norton Backup  as the  time that  the
  308.    tape-drive is  accessed. After  the configured  number of  minutes of
  309.    Norton Backup usage (= aprox.  tape-drive usage), NBS will display  a
  310.    warning to clean the drive;
  311.  
  312.  - NBS will pass the  original errorlevel from Norton Backup  execution.
  313.    Also NBS will be able to run unattended, when /A or a macro-setup  is
  314.    detected  on  the  Norton  Backup  command-line.  In these cases, all
  315.    warnings  are  displayed  (for  example  the  warning  to  clean  the
  316.    tape-drive) but  there will  be no  user interaction  and the warning
  317.    will continue to appear until  you run an attended execution  of NBS.
  318.    NBS will keep  a small log-file  that can be  used as reference  when
  319.    you ALWAYS run NBS in an unattended fashion;
  320.  
  321.  All in all, a number  of pre/post processing options for  Norton Backup
  322.  that can get even more from Norton Backup.
  323.  
  324.  
  325.  
  326.  2.2 Requirements
  327.  ───────────────────────────────────────────────────────────────────────
  328.  NBS requires:      - PC XT/AT/386/486 (or more)
  329.                     - At least 400K free memory;
  330.                     - DOS 3.xx and higher;
  331.                       (tested with 4Dos 4.0, should work with lower
  332.                       versions);
  333.                     - DOS 2.xx ONLY when registered. In this case, a
  334.                       customized version will be created;
  335.                     - HDU optional
  336.                     - The original Norton Backup <tm> version 2.2
  337.                       (should work with lower and compatible versions
  338.                       as well);
  339.                     - A copy of PKWare's PKZIP.EXE and PKUNZIP.EXE;
  340.  
  341.  
  342.  2.3 Included files
  343.  ───────────────────────────────────────────────────────────────────────
  344.  The package includes : NBS.EXE         The main program
  345.                         NBS.INI         An example configuration file
  346.  
  347.  ┌───────┬─────────────────────────────────────────────────────────────┐
  348.  │   3   │ Installation description                                    │
  349.  └───────┴─────────────────────────────────────────────────────────────┘
  350.  
  351.  3.1 Installation
  352.  ────────────────────────────────────────────────────────────────────────
  353.  The installation  of NBS  depends upon  the way  you use Norton Backup.
  354.  You can choose either one of  the suggested ways.  After unpacking  the
  355.  archive in a temporary directory, you can go as follows:
  356.  
  357.  If your Norton Backup is  ALWAYS called from a command-line  (either by
  358.  hand or in a batch-file)  but NOT FROM the NSCHED.COM  schedule program
  359.  that comes with Norton Backup, the installation is as follows:
  360.  
  361.  - Copy the NBS.EXE file to a directory in the DOS-path;
  362.  
  363.  - Copy the  NBS.INI file to  the same directory  or a directory  in the
  364.    DOS-path and alter the contents to suit your needs (see later);
  365.  
  366.  - Alter ALL  calls to Norton  Backup (NBACKUP.EXE) in  all your batches
  367.    (*.BAT or *.BTM)  to NBS.EXE, also  always call NBS  from the command
  368.    line and not NBACKUP;
  369.  
  370.  If your Norton Backup is  sometimes called from a command-line  (either
  371.  by hand or  in a batch-file)  AND ALSO FROM  the schedule program  that
  372.  comes with Norton Backup (NSCHED.COM), the installation is as follows:
  373.  
  374.  - Rename  NBACKUP.EXE in  the Norton  Backup directory  to an alternate
  375.    name (NB.EXE for example);
  376.  
  377.  - Copy the  NBS.EXE file to  the directory where  NBACKUP.EXE (that you
  378.    should have  renamed by  now) resides  and rename  it to  NBACKUP.EXE
  379.    (NBS.EXE is now called NBACKUP.EXE and the original NBACKUP.EXE  also
  380.    has another name);
  381.  
  382.  - Copy the  NBS.INI file to  the same directory  or a directory  in the
  383.    DOS-path and alter the contents to suit your needs (see later).   You
  384.    MUST add the  NortonBackUpProgram option in  the [Norton] section  of
  385.    the NBS.INI file and  this MUST now point  to the renamed version  of
  386.    the original NBACKUP.EXE file;
  387.  
  388.  - You can leave all calls to NBACKUP as they were as NBS is now  called
  389.    instead;
  390.  
  391.  
  392.  In ALL of the above cases:
  393.  
  394. │- Check  if  there is a README.NBS in the release archive. If so, first
  395. │  read the information contained in that file;
  396.  
  397.  - After you have altered NBS.INI, you should start with the first  call
  398.    to NBS.EXE (called NBS.EXE or NBACKUP.EXE) in the following way:
  399.  
  400.    - NBS /NBSFTM
  401.  
  402.      - NBS will call the Norton  Backup Program which you should end  at
  403.        the same time;
  404.  
  405.      - NBS will create the first NBS.ZIP file in the assigned directory;
  406.  
  407.    This is MANDATORY.  The /NBSFTM is  used to tell  NBS that it  is the
  408.    first time  execution and  that no  NBS.ZIP file  is available.  This
  409.    could also  be automated  but this  way is  a more  safe way in those
  410.    cases where the NBS.ZIP file is removed by accident.
  411.  
  412.  The above sequence is also important to check your NBS.INI file and  to
  413.  check if all is working OK.
  414.  
  415.  
  416.  3.2 The configuration file(s)
  417.  ────────────────────────────────────────────────────────────────────────
  418.  All programs from the NBS package make use of ONE SINGLE  configuration
  419.  file that is called  NBS.INI. The NBS.INI file  is typically a file  of
  420.  the new  generation of  control-files. The  syntax is  derived from the
  421.  Microsoft Windows <tm>, MS/DOS <tm> (CONFIG.SYS) and OS/2 syntax.
  422.  
  423.  The NBS.INI file is  a normal ASCII (flat)  file with records that  are
  424.  terminated by a CR/LF combination. Most present-day (line) editors  can
  425.  create such  a file  and also  most word-processors  have the option to
  426.  create a (flat) ASCII file (without control-codes!).
  427.  
  428.  There  are  no  formal  rules  for  the syntax of a Windows-alike *.INI
  429.  file.  The  basic  syntax  though  is  in  the  form  of blocks (with a
  430.  block-header) with options. All options between a block-header and  the
  431.  next block-header  (or the  end of  the file)  belong to  the block for
  432.  which the block-header  gives a name.  A block-header is  assigned thru
  433.  the use of brackets before and after the name of the block. Like this:
  434.  
  435.  [General]
  436.  OptionG1=value1
  437.  OptionG2=value2
  438.  
  439.  [Custom]
  440.  OptionC1=value1
  441.  OptionC2=value2
  442.  
  443.  In the example above, there  are two blocks (General and  Custom) which
  444.  are  marked  by  their  block-headers  ([General]  and  [Custom]).  The
  445.  options OptionG1  and OptionG2  belong to  the block  'general' and the
  446.  options OptionC1  and OptionC2  belong to  the block  'custom'.   Until
  447.  MS/DOS 6.0 <tm> it seemed like a rule that a *.INI file could not  have
  448.  duplicate variants of  the same options.  In such cases,  it was common
  449.  to use something like this:
  450.  
  451.  [Custom]
  452.  ExcludeFile-1 = A.A
  453.  ExcludeFile-2 = B.B
  454.  
  455.  or
  456.  
  457.  [Custom]
  458.  ExcludeFile = A.A , B.B
  459.  
  460.  and not
  461.  
  462.  [Custom]
  463.  ExcludeFile = A.A
  464.  ExcludeFile = B.B
  465.  
  466.  Ms/DOS 6.0  <tm> changed  this behavior.  The 'MenuItem'  option is  an
  467.  example of how to break the 'rules'. DISP programs, like NBS, will  now
  468.  use all combinations. In most cases, the variant used, is based on  the
  469.  number  of  possible  values.  When  you  want to exclude more than 100
  470.  files,  both  'ExcludeFile  =  A.A,  B.B,  C.C......' and the form with
  471.  'ExcludeFile-1 =',  'ExcludeFile-2='.... and  so on,  are both useless.
  472.  In these cases,  multiple (duplicate) variants  of the same  option are
  473.  used.
  474.  
  475.  The format of the *.INI file is rather free. The block-headers must  be
  476.  coded as given and  must be enclosed in  brackets. The header (and  the
  477.  options) can start on  any position in the  *.INI file as long  as they
  478.  are  preceded  with  'white'  spaces.  Options  (and  headers) that are
  479.  preceded with a  comment-character ('%'), are  not used, nor  are empty
  480.  lines and invalid options ! The options have the format:
  481.  
  482.  Optionname = value
  483.  
  484.  The '=' character is used to  separate the option and its value(s).  If
  485.  multiple values  precede the  '=' character,  they are  separated by  a
  486.  comma or another character  (like Optionname = value,value,value).  The
  487.  number of  white spaces  between the  optionname and  the '=' character
  488.  and the '='  character and the  value(s) is irrelevant.  An option will
  489.  never exceed one line and a line can never be more than 255  characters
  490.  long.  The case (upper/lower) of all options, block-headers and  values
  491.  is not important, unless specified.
  492.  
  493.  The names used thru all DISP <tm> products are as follows:
  494.  
  495.  - Block-name
  496.    The name of the block that  is preceded with a block-header and  will
  497.    be  active  until  the  next  block-header  or the end of file (which
  498.    comes first);
  499.  
  500.  - Option
  501.    The name of the options within a block;
  502.  
  503.  - Parameter or values
  504.    These are the actual values that belong to an option. Sometimes  they
  505.    are  called  parameter,  but  most  of  the  time we will call them a
  506.    value.
  507.  
  508.  The descriptive syntax of all options is:
  509.  
  510.  [.....]   this value is MANDATORY, it MUST be present and have a  valid
  511.            value;
  512.  
  513.  {.....}   this  value is OPTIONAL. If  it is NOT present,  some default
  514.            is used;
  515.  
  516.  'value'   Values  between  quotes   must  be  coded WITHOUT the  quotes
  517.            themself, UNLESS specified;
  518.  
  519.  The DISP  programs (including  the programs  in the  NBS package)  will
  520.  look for the control-file (NBS.INI in  case of the NBS package) in  the
  521.  following way:
  522.  
  523.  - First the current directory is searched for the NBS.INI file;
  524.  
  525.  - If not present in the  current directory, a search thru the  DOS-path
  526.    is performed until the NBS.INI file is found;
  527.  
  528.  - If the NBS.INI file is not found in the current directory and/or  the
  529.    DOS-path, the directory  where the EXE-file  resides (if this  is not
  530.    the same directory as the  current directory) will be examined.  This
  531.    search is only performed with DOS releases 3.xx and higher;
  532.  
  533.  It is advised to place  the NBS.INI file alongside the  programs and/or
  534.  somewhere in the DOS-path.
  535.  
  536.  The following  chapter   will   contain the  various statements you can
  537.  use in the file.
  538.  
  539.  
  540.  3.3 INI options
  541.  ───────────────────────────────────────────────────────────────────────
  542.  The  next   chapters  contain   the  options   for all programs in  the
  543.  NBS package.
  544.  
  545.  The descriptions are grouped together  in the same blocks as  they have
  546.  to  appear  in  NBS.INI.  Please  refer  to the example NBS.INI that is
  547.  supplied with this package !
  548.  
  549.  
  550.  3.3.1 [General] options
  551.  ───────────────────────────────────────────────────────────────────────
  552.  The following  options, if  defined, must  be defined  inside the block
  553.  with block-header [General]
  554.  
  555.  
  556.  ┌─────────────────────────────────────────────────────────────────────┐
  557.  │ TemporaryDirectory = [dir]                                          │
  558.  └─────────────────────────────────────────────────────────────────────┘
  559.  Usage : NBS  will  create  some   temporary  files  and  a    temporary
  560.          directory.   This  option  (if  available)  will  point  to the
  561.          directory  where  these  temporary  files/directory  is placed.
  562.          When the  option is  NOT available  in NBS.INI,  NBS will check
  563.          for  the  directory  that  is  set  in the environment variable
  564.          TEMP. If this variable is also NOT available, NBS will abort,
  565.  
  566.          [dir] Must  point  to  a   valid  directory. The program   will
  567.                test if  the directory  is available   and will  abort if
  568.                this  is not the case. You can use relative paths !
  569.  
  570.  
  571.  ┌─────────────────────────────────────────────────────────────────────┐
  572.  │ StoreDirectory = [dir]                                              │
  573.  └─────────────────────────────────────────────────────────────────────┘
  574.  Usage : NBS will create and use a special file NBS.ZIP (PKZIP  archive)
  575.          which will contain all sets, catalogs and other related  files.
  576.          NBS  will  extract  files  from  this  archive into the NBackup
  577.          data-directory (see NB2.2  manual, NBACKUP env.  variable). You
  578.          CAN place this file in the  same directory but I advise to  use
  579.          another  directory  where  you  store  these  kind of important
  580.          files. The StoreDirectory option IS MANDATORY and should  point
  581.          to a valid directory where NBS.ZIP is placed and read from.
  582.  
  583.          [dir] Must  point  to  a   valid  directory. The program   will
  584.                test if  the directory  is available   and will  abort if
  585.                this  is not the case.
  586.  
  587.  
  588.  ┌─────────────────────────────────────────────────────────────────────┐
  589.  │ LogPath = [path]                                                    │
  590.  └─────────────────────────────────────────────────────────────────────┘
  591.  Usage : NBS can create a  log-file with all actions. This log-file  can
  592.          be reused, in which case NBS will append to the file, with  all
  593.          next executions. If you want  to have a log-file maintained  by
  594.          NBS, you must include this option.
  595.  
  596.          [path] must either point to  a valid directory (with drive  and
  597.                 directory-name), in which  case NBS will  create NBS.LOG
  598.                 inside  this  directory  or   must  point  to  a   fully
  599.                 specified name  (drive, directory  and filename)  of you
  600.                 log-file, if you want to use another name than NBS.LOG.
  601.  
  602.  
  603.  ┌─────────────────────────────────────────────────────────────────────┐
  604.  │ MergeNBackupLog = [true | false]                                    │
  605.  └─────────────────────────────────────────────────────────────────────┘
  606.  Usage : If your Norton Backup  sets are configured to create a  history
  607.          log-file (not to  be confused with  the *.INC and  *.FUL files)
  608.          with one or  more items included  inside this log,  NBS is able
  609.          to merge this  log into the  NBS log-file (if  set, see above).
  610.          In this case,  NBS will append  all created *.RPT  files in the
  611.          Norton Backup data-directory  into the configured  NBS log-file
  612.          AND will delete these  *.RPT files from the  data-directory. If
  613.          you do not specify this option (or set it to FALSE), the  *.RPT
  614.          will be kept in the  data-directory and will be moved  into the
  615.          NBS.ZIP  file  by  NBS  after  Norton Backup has terminated. It
  616.          will  also  be  extracted  if  next  actions  on  this  set are
  617.          required  so  Norton  Backup  is  still  able  to  append   new
  618.          information to the *.RPT file.
  619.  
  620.          You can either use the TRUE or  FALSE values or use the Y or  N
  621.          values in NBS.INI.
  622.  
  623.  
  624.  ┌─────────────────────────────────────────────────────────────────────┐
  625.  │ UseEMS = [true | false]                                             │
  626.  └─────────────────────────────────────────────────────────────────────┘
  627.  Usage:  NBS will  swap itself  out of  memory before PKZIP/PKUNZIP  and
  628.          the Norton Backup program are called.
  629.  
  630.          Normally  the  swap   routine   will  use   XMS  (first),   EMS
  631.          (second)  or   DISK  (third),   depending  on   the   available
  632.          resources.
  633.  
  634.          If you  don't want  to use   EMS as  a candidate  for swapping,
  635.          you should supply  'UseEMS = false'  or 'UseEMS =  N' (both are
  636.          valid values for this option).
  637.  
  638.          The default (when   you don't supply   the option in   NBS.INI)
  639.          is to  use EMS  when selected,  available and  when enough  EMS
  640.          memory is available.
  641.  
  642.          You   can   supply   both   UseEMS   and   UseXMS  together, to
  643.          allow either  any  type  of   memory  (both  set to true),  one
  644.          type of memory  (one  set  to  true,  the  other  to  false) or
  645.          NO type of memory (both set to false).
  646.  
  647.  
  648.  ┌─────────────────────────────────────────────────────────────────────┐
  649.  │ UseXMS = [true | false]                                             │
  650.  └─────────────────────────────────────────────────────────────────────┘
  651.  Usage : NBS will  swap itself  out of  memory before PKZIP/PKUNZIP  and
  652.          the Norton Backup program are called.
  653.  
  654.          Normally  the  swap   routine   will  use   XMS  (first),   EMS
  655.          (second)  or   DISK  (third),   depending  on   the   available
  656.          resources.
  657.  
  658.          If you  don't want  to use   XMS as  a candidate  for swapping,
  659.          you should supply  'UseXMS = false'  or 'UseXMS =  N' (both are
  660.          valid values for this option).
  661.  
  662.          The default (when   you don't supply   the option in   NBS.INI)
  663.          is to  use XMS  when selected,  available and  when enough  XMS
  664.          memory is available.
  665.  
  666.          You   can   supply   both   UseEMS   and   UseXMS  together, to
  667.          allow either  any  type  of   memory  (both  set to true),  one
  668.          type of memory  (one  set  to  true,  the  other  to  false) or
  669.          NO type of memory (both set to false).
  670.  
  671.  
  672.  ┌─────────────────────────────────────────────────────────────────────┐
  673.  │ PKZIPProgram = [path]                                               │
  674.  └─────────────────────────────────────────────────────────────────────┘
  675.  Usage : NBS  will need a  copy of the  PKZIP.EXE file (from  PKWare) to
  676.          create the NBS.ZIP file. Any version from 1.00 and up will  do.
  677.          This option can point to  the PKZIP.EXE program. If the  option
  678.          is not  available, NBS  will try  to find  PKZIP.EXE in the DOS
  679.          path.
  680.  
  681.          [path] Must point to the valid directory and  file-name of  the
  682.                 PKZIP program.
  683.  
  684.  
  685.  ┌─────────────────────────────────────────────────────────────────────┐
  686.  │ PKUNZIPProgram = [path]                                             │
  687.  └─────────────────────────────────────────────────────────────────────┘
  688.  Usage : NBS will need a  copy of the PKUNZIP.EXE file (from  PKWare) to
  689.          create the NBS.ZIP file. Any version from 1.00 and up will  do.
  690.          This  option  can  point  to  the  PKUNZIP.EXE  program. If the
  691.          option is not  available, NBS will  try to find  PKUNZIP.EXE in
  692.          the DOS path.
  693.  
  694.          [path] Must point to the valid directory and  file-name of  the
  695.                 PKZIP program.
  696.  
  697.  
  698.  3.3.2 [Norton] options
  699.  ───────────────────────────────────────────────────────────────────────
  700.  The following  options, if  defined, must  be defined  inside the block
  701.  with block-header [Norton].
  702.  
  703.  ┌─────────────────────────────────────────────────────────────────────┐
  704.  │ NortonBackupProgram = [path]                                        │
  705.  └─────────────────────────────────────────────────────────────────────┘
  706.  Usage : NBS will need a copy of the Norton Backup program  (NBACKUP.EXE
  707.          or a  renamed equivalent,  see chapter  3.1).   This option can
  708.          point  to  the  Norton  Backup  program.  If  the option is not
  709.          available, NBS will try to find the NBACKUP.EXE program in  the
  710.          DOS-path.  This  can  cause  loops  if  NBS.EXE  is  renamed to
  711.          NBACKUP.EXE,  so  be  careful  to  include this option with the
  712.          correct name of the renamed  NBACKUP.EXE when this is the  case
  713.          !!
  714.  
  715.          [path] Must point to the valid directory and  file-name of  the
  716.                 Norton Backup program.
  717.  
  718.  
  719.  ┌─────────────────────────────────────────────────────────────────────┐
  720.  │ NortonFilesDir = [dir]                                              │
  721.  └─────────────────────────────────────────────────────────────────────┘
  722.  Usage : Normally NBS will use a separate data-directory (see the  NB2.2
  723.          manual about  the NBACKUP  env.var.). This  data-directory will
  724.          contain the SET/CAT/SLT/SAV/INC/FUL (and  so on) files. If  the
  725.          NBACKUP env.var.  is not  set, the  Norton Backup  directory is
  726.          used.
  727.  
  728.          If the NBACKUP  environment variable is  NOT set, the  usage of
  729.          this NortonFilesDir option  is MANDATORY, even  if you use  the
  730.          Norton Backup directory. NBS needs  to know WHERE to place  the
  731.          files that come from NBS.ZIP.  If the NBACKUP env.var. is  set,
  732.          you can leave out this option !
  733.  
  734.          [dir] Must  point  to  a   valid  directory. The program   will
  735.                test if  the directory  is available   and will  abort if
  736.                this  is not the case.
  737.  
  738.  
  739.  ┌─────────────────────────────────────────────────────────────────────┐
  740.  │ DeleteNortonTemp = [mask] {,mask} {,mask} {,mask} {,mask}           │
  741.  └─────────────────────────────────────────────────────────────────────┘
  742.  Usage : This option  will trigger  a NBS  post-processing option.   NBS
  743.          will delete all files that match one or more of the masks  that
  744.          you supply overhere. For example:
  745.  
  746.          DeleteNortonTemp= NBACKUP.* RESTORE.TMP *.BAK
  747.  
  748.          Will delete NBACKUP.LOG, NBACKUP.RST, NBACKUP.TMP,  RESTORE.TMP
  749.          and *.BAK  file AFTER  Norton Backup  has finished  processing.
  750.          This keeps the  Norton Backup directory  (and the NBS.ZIP  file
  751.          that is maintained by NBS) clean.
  752.  
  753.          [mask] must  be  a  valid  DOS  mask (like *.BAK or  FILE.NOW).
  754.                 There must be at least  one mask set and optionally  you
  755.                 can supply more masks (20) which must be separated by  a
  756.                 comma.
  757.  
  758.  
  759.  3.3.3 [Cycle] options
  760.  ───────────────────────────────────────────────────────────────────────
  761.  The following  options, if  defined, must  be defined  inside the block
  762.  with block-header [Cycle].
  763.  
  764.  ┌─────────────────────────────────────────────────────────────────────┐
  765.  │ CycleSet1  = [set-name], [count], [text]                            │
  766.  │ CycleSet2  = [set-name], [count], [text]                            │
  767.  │ CycleSet3  = [set-name], [count], [text]                            │
  768.  │ CycleSet4  = [set-name], [count], [text]                            │
  769.  │ CycleSet5  = [set-name], [count], [text]                            │
  770.  │ CycleSet6  = [set-name], [count], [text]                            │
  771.  │ CycleSet7  = [set-name], [count], [text]                            │
  772.  │ CycleSet8  = [set-name], [count], [text]                            │
  773.  │ CycleSet9  = [set-name], [count], [text]                            │
  774.  └─────────────────────────────────────────────────────────────────────┘
  775.  Usage : You can  instruct NBS that you  maintain sets of media  for the
  776.          backup-process.  In  this  case  (mostly  used with tapes), you
  777.          maintain, for  instance, 3  tapes. The  first tape  is used  to
  778.          keep a full backup and  all next incremental backups until  the
  779.          next full backup is performed. When this is the case, you  will
  780.          then store the next  full backup (and its  incremental backups)
  781.          on the 2nd tape  until the next full  backup. In that case  you
  782.          will  use  the  3th  tape.  When  the  next  full backup is now
  783.          requested you start to reuse the 1th tape and the cycle  starts
  784.          again.
  785.  
  786.          To accommodate this feature (for  up to 10 different set),  you
  787.          can supply the  CycleSet[x] option, where  [x] has the  value 1
  788.          to 9. If present  (and match the current set to be worked  on),
  789.          NBS  will  display  a  message  which  tape to use. There is NO
  790.          check to  see if  this is  the correct  tape. This  is left  to
  791.          Norton Backup or yourself.  If you run unattended,  the message
  792.          will appear but NBS will not wait for a key-stroke. If you  run
  793.          attended, NBS will beep and wait for a keystroke.
  794.  
  795.          Each option will name  the point to the  set it applies to,  it
  796.          will contain the number of backup device-sets (tapes) you  want
  797.          to  use  and  contains  a  text  to be displayed. This text can
  798.          either contain a variable tape-number or tape-letter which  can
  799.          be incorporated inside the text.
  800.  
  801.          [set-name]  This must  contain the  name of  the set for  which
  802.                      the  cycle  control  is  active.  Don't  supply  an
  803.                      extension, only the name.
  804.  
  805.          [count]     This must  be set to  the number of   backup-device
  806.                      sets (tapes) you want  to maintain for this  backup
  807.                      (or restore).  You can  supply any  number but when
  808.                      your (virtual) tape-labels have letters (like  TAPE
  809.                      A, TAPE B and so on), you can only supply a  number
  810.                      up to 26;
  811.  
  812.          [text]      This   must  be  the  text   that  you  want to  be
  813.                      displayed by  NBS. You can include three macros. $A
  814.                      will be  substituted by  the correct  letter (A, if
  815.                      it is the first set,  B for the second and  so on).
  816.                      $N will  be substituted  by the  correct number  (1
  817.                      for the first  tape, 2 for  the second and  so on).
  818.                      You can also supply  $N1, $N2... $N9 in  which case
  819.                      the  number  will  be  padded  with  0  to 8 zeroes
  820.                      before the  number (the  length of  the number will
  821.                      be 1 to 9). $S will be substituted with the name of
  822.                      the SET that is currently in use;
  823.  
  824.          For example, you use TAPE 001,  TAPE 002 and TAPE 003 for  your
  825.          3-week cycle of  backups of your  hard-disk. The Norton  Backup
  826.          set that is used, is called FULLBACK.SET:
  827.  
  828.          CycleSet1 = FULLBACK, 3 , Use TAPE $N3 this week for $S
  829.  
  830.          NBS will display the first week:
  831.  
  832.          'Use TAPE 001 this week for FULLBACK'
  833.  
  834.          And the 3th week:
  835.  
  836.          'Use TAPE 003 this week for FULLBACK'
  837.  
  838.          It is up to you  (and the Norton Backup schedular)  to maintain
  839.          the  correct  sequence  of  full  and  incremental backups. The
  840.          options will  only work  when /TF  (full) or  /TI (incremental)
  841.          command-line  parameters  are  included  with  the  call to the
  842.          Norton Backup program. NSCHED will do this !
  843.  
  844.          See  also  chapter  4  for  specific  details about the NBS.STA
  845.          file.
  846.  
  847.  
  848.  ┌─────────────────────────────────────────────────────────────────────┐
  849.  │ CycleClean = [minutes]                                              │
  850.  └─────────────────────────────────────────────────────────────────────┘
  851.  Usage : You can  instruct NBS to track  the number of minutes  that the
  852.          backup-device is used.  This is an  estimate, because NBS  will
  853.          start to count when Norton Backup is called and will stop  when
  854.          Norton Backup is finished.  Usually you will perform  automatic
  855.          actions  with  Norton  Backup  but  if  you include many manual
  856.          input during the  activation of Norton  Backup, this time  will
  857.          also be counted.
  858.  
  859.          Usually this option is only  useful when you use a  tape-drive.
  860.          Diskette drives  are also  used outside  Norton Backup  but the
  861.          tape-drive is  (normally) only  accessed by  Norton Backup  for
  862.          long  periods.  Tape  drives  should  be  cleaned  on a regular
  863.          frequency (see the manual of your tape-drive).
  864.  
  865.          NBS will  add each  time that  Norton Backup  was called to the
  866.          previous  total.  If  the  total  has  become  bigger  than the
  867.          configured number of minutes, NBS will supply a message on  the
  868.          screen. If NBS runs unattended, the message will appear but  no
  869.          keystroke is  needed. In  this case  the message  will reappear
  870.          until  an  attended  call   to  NBS  is  made   (no  /A  or   a
  871.          marco-execution on the command-line). If NBS run attended,  NBS
  872.          will display the  message, will wait  for a keystroke  and will
  873.          then reset the cycle (after  which the counting will start  all
  874.          over). This is independent of the fact if you actually  cleaned
  875.          the drive. This is your job and can not be monitored by NBS.
  876.  
  877.          [minutes] should  be  set  to  the  estimate number of  minutes
  878.                    after which a cleaning  action of your backup  device
  879.                    is needed.  If no  cleaning cycle  is needed,  supply
  880.                    the value 0.
  881.  
  882.          See  also  chapter  4  for  specific  details about the NBS.STA
  883.          file.
  884.  
  885.  ┌───────┬─────────────────────────────────────────────────────────────┐
  886.  │   4   │ Runtime information                                         │
  887.  └───────┴─────────────────────────────────────────────────────────────┘
  888.  
  889.  4.1 Modes of operation
  890.  ───────────────────────────────────────────────────────────────────────
  891.  NBS can be operated in various modes:
  892.  
  893.  - NBS  will  be  used  to  call  Norton  Backup, while performing  some
  894.    processes  before  Norton  Backup  is  called  (pre-processing)   and
  895.    performing  some  processed  after  Norton  Backup  finished  (called
  896.    post-processing).  Optionally,   you  must   supply  a   NBS-specific
  897.    parameter to tell NBS that it  is the first time it will  execute (it
  898.    will then  assume that  there is  no NBS.ZIP  file available and will
  899.    create a new one at the end of this process);
  900.  
  901.  - NBS will be used to checkout the current collection of SET, SAV,  SLT
  902.    and CAT files  against INC, DIF  and FUL files.  In this process  the
  903.    files  from  COPY-functions  of  Norton  Backup  are ignored. In this
  904.    mode, Norton Backup itself is NOT called;
  905.  
  906.  - NBS can update the NBS.STA (statistical) file to values you like;
  907.  
  908.  It is advised to run NBS  in the check-operation the first time  (or as
  909.  soon as possible).  In the installation  we recommended to  call NBS in
  910.  the mode that calls Norton Backup  because most of you will read  until
  911.  they know  how to  install. In  that case,  the chapter  about checking
  912.  (see later) is  not read and  it would be  possible that the  user gets
  913.  messages and questions that can not be answered with full knowledge  of
  914.  what is happening.
  915.  
  916.  
  917.  4.1.1 First time execution
  918.  ───────────────────────────────────────────────────────────────────────
  919.  As  said,  the  first  time  you  call  NBS,  there  is no NBS.ZIP file
  920.  present.  NBS  could detect this  itself, but for  security reasons, we
  921.  force  the  user  to  actually  supply  options that will tell NBS that
  922.  there is no NBS.ZIP (it could  be possible that the NBS.ZIP file  could
  923.  not be accessed while  it IS present. In  this case NBS would  assume a
  924.  first run and would make a mess of the next call to Norton Backup).
  925.  
  926.  To  tell  NBS  that  it  executes  the  first time, you must supply the
  927.  command-line parameter /NBSCHK to NBS.  This is an unknown command  for
  928.  Norton Backup and is  filtered out by NBS  before NBS calls the  Norton
  929.  Backup program.
  930.  
  931.  
  932.  4.1.2 Standard calls
  933.  ───────────────────────────────────────────────────────────────────────
  934.  With a standard call,  we mean a call  to Norton Backup, either  from a
  935.  normal batch file or from the  command-line. The call can be meant  for
  936.  a specific SET or for  a non-specific reason (like a  tape-directory or
  937.  the creation of a new SET).
  938.  
  939.  All calls that  don't include the  /NBSCHK command-line parameters  are
  940.  treated as normal  calls to Norton  Backup. When NBS  receives a normal
  941.  call, the following sequence is performed:
  942.  
  943.  - Check NBS command-line  to see if there  is a specific SET  specified
  944.    (like NBS Fullback /TI /A, where FULLBACK is the name of the SET);
  945.  
  946.  - Check NBS command-line to see if there is a macro execution  involved
  947.    or an  automated process  (either NBS  @FULLBACK /TI  or NBS FULLBACK
  948.    /TI /A);
  949.  
  950.  - Check to see if /NBSFTM is on the command-line parameters;
  951.  
  952.  - If no /NBSFTM is included, unpack the SET and its related  components
  953.    from  NBS.ZIP.  If  NO  SET  is  specified, unpack ALL SETs and their
  954. │  related  components. If  a  SET is supplied that doesn't exist in the
  955. │  NBS.ZIP archive, continue  with  the  next step, without extracting a
  956. │  specific  SET. Norton  Backup will ask you if you want to create this
  957. │  (new) set when it starts;
  958.  
  959.  - If no /NBSFTM is  included, unpack the PROTECT.LST file  (if present)
  960.    from the NBS.ZIP (REMAINDR.NBS directory inside the ZIP);
  961.  
  962. │- Copy the PROTECT.LST to the PROTECT.NBS file if there was such a file
  963. │  present in the NBS.ZIP file;
  964.  
  965. │- Now check if there are INC/FUL/DIF files inside the NBS.ZIP file that
  966. │  have a  mask of ??jmmddl.??? where 'j' is the last digit of this year
  967. │  (e.g. '3' of 1993), 'mm' is  the number of the current month, 'dd' is
  968. │  the number of the current day and 'l' is a letter from 'A' to 'Z'. If
  969. │  this is the case, NBS will  first create (a) 0-length file(s) of that
  970. │  name inside the working directory. This is to overcome the problem of
  971. │  getting two INC/FUL/DIF files  with the same name for different SET's
  972. │  (e.g. a CE30925A.FUL for FULLBACK.SET and CE30925A.FUL for CEDRI.SET)
  973. │  when you backup with different sets (but the same drives) on the same
  974. │  day;
  975.  
  976.  - Determine the  backup-device set (tape),  if cycle-control is  active
  977.    and matches the set that will be worked on;
  978.  
  979.  - Call Norton Backup;
  980.  
  981.  - On return from Norton Backup, remove all temporary files as specified
  982.    in NBS.INI;
  983.  
  984.  - Merge any *.RPT (report) file to the NBS.LOG (if configured). If such
  985. │  file is present, also  examine if the total backup-time  is available
  986. │  inside the file;
  987.  
  988.  - Intelligently merge the PROTECT.NBS and the new PROTECT.LST  together
  989.    and create a  new PROTECT.LST. This  is needed because  Norton Backup
  990. │  will  create  a  new  PROTECT.LST  each  time  it executes. If no new
  991. │  PROTECT.LST is created, NBS will copy the complete PROTECT.NBS to the
  992. │  new PROTECT.LST file;
  993.  
  994.  - Calculate the  number of minutes  the backup/restore-device was  used
  995. │  and trigger when  the total  time expired the configured period. This
  996. │  will either be the time that  Norton Backup was active OR will be the
  997. │  time that is extracted from any present *.RPT file;
  998.  
  999. │- Remove all 0-length INC/FUL/DIF files that were created previously;
  1000.  
  1001.  - Pack all (new  and old) files into  the NBS.ZIP, even new  SETs which
  1002.    are created during the execution  of Norton Backup, are added  to the
  1003.    NBS.ZIP file, so don't worry;
  1004.  
  1005.  - Terminate NBS with the errorlevel returned by Norton Backup;
  1006.  
  1007.  NBS will manipulate the PROTECT.LST  file in a special way,  because of
  1008.  the  way  Norton  Backup  maintains  this  file.  The  result will be a
  1009.  complete (!) and correct  protection-list, even when Norton  Backup can
  1010.  not detect  all protected  SETs because  these files  are not extracted
  1011.  from the NBS.ZIP file.
  1012.  
  1013.  When NBS extracts files from  NBS.ZIP, it will reset the  attributes to
  1014.  0, so Norton Backup  will only backup them  with a full backup  but not
  1015.  with  every  incremental  backup.   The  same  goes  for   PROTECT.LST,
  1016.  PROTECT.NBS and every other file EXPECT NBS.ZIP.
  1017.  
  1018.  
  1019.  4.1.3 Automated (scheduled) calls
  1020.  ───────────────────────────────────────────────────────────────────────
  1021.  An  automated  or  scheduled  call  is  performed  when you install the
  1022.  Norton Scheduler program (NSCHED.COM).  NSCHED will call Norton  Backup
  1023.  with a  certain command-line  on the  scheduled dates,  for a scheduled
  1024.  action  or  when  you  call  Norton  Backup  from a batch with either a
  1025.  macro-execution (the  @ before  the name  of the  SET) or  with the  /A
  1026.  switch.
  1027.  
  1028.  The actions that NBS performs with  an automated call, are the same  as
  1029.  with standard calls, all expect one difference. The difference  between
  1030.  the  two  modes  is  the  fact  that  NBS  will  never  wait for a user
  1031.  keystroke on a question. This means that:
  1032.  
  1033.  - NBS will display any pending tape-number for a backup starts (if  any
  1034.    CycleSetx option matches the SET) but NBS will not stop. It is up  to
  1035.    the user that the correct media is inserted in the drive;
  1036.  
  1037.  - NBS  will display  any pending  expiration of  the cleaning cycle but
  1038.    that  it  will  NOT  reset  the  cleaning-cycle until after the first
  1039.    NON-automated call of NBS;
  1040.  
  1041.  The current version of NSCHED will call Norton Backup with all  options
  1042.  that need to be supplied (both /TF and /TI are of any interest to  NBS)
  1043.  independent  of  the  installed  defaults  for  a given SET. With other
  1044.  words if  your default  for FULLBACK.SET  is an  incremental backup and
  1045.  NSCHED has to perform an incremental backup, /TI is still supplied.
  1046.  
  1047.  
  1048.  4.1.4 Checking
  1049.  ───────────────────────────────────────────────────────────────────────
  1050.  After a certain time it could be possible that there are mismatches  in
  1051.  your Norton  Backup data-files.  This is  not the  case if  you use the
  1052.  correct options  AND leave  all your  data as-is,  but normally it will
  1053.  happen that  you create  an invalid  SET (wrong  name), export  certain
  1054.  INC/FUL files  to other  media or  for other  reasons. NBS  is able  to
  1055.  check  the  majority  of  data-files  that  reside in the Norton Backup
  1056.  data-dir.  This  is done by  calling NBS with  the /NBSCHK command-line
  1057.  parameter.  NBS will do the following:
  1058.  
  1059.  - NBS will unpack ALL files from NBS.ZIP into the data-directory;
  1060.  
  1061.  - It will read all catalog (CAT) files;
  1062.  
  1063.  - It  will  compare  all  SET's  against  CAT's.  If  a CATalog has  no
  1064.    matching SET file,  a message is  displayed. You now  have the option
  1065.    to delete the CAT(alog) file  and all other related files.  These are
  1066.    the SAV, SLT, BAK and RPT files with the same name as the CAT(alog);
  1067.  
  1068.  - It will compare all CAT's against  SET's. If a SET has no catalog,  a
  1069.    message is displayed. You now have  the option to delete the SET  and
  1070.    all belonging files (see previous point);
  1071.  
  1072.  - Now NBS will compare CAT files against the files that belong to  that
  1073.    CAT file. If a CAT points to a file (f.i. a *.INC or *.FUL file)  and
  1074.    that file is NOT present, you have the option to delete the CAT  file
  1075.    and all remaining (related) files. You can also do this by hand.  The
  1076.    fact remains that the CAT-file points to an incomplete set of  files.
  1077.    Another option  is to  restore one  or more  of the *.INC/*.FUL files
  1078.    from the backup-media (if present);
  1079.  
  1080.  - The reversed is  tested. NBS will check  if there remain files  (INC,
  1081.    FUL DIF and  so on) that  don't belong to  any catalog. You  have the
  1082.    option to remove that orphan file or you can check manually;
  1083.  
  1084.  - Last, NBS will check if  there are files that belong to  multiple CAT
  1085.    files. This  can happen  when Norton  Backup creates  a backup with a
  1086.    file like  CE30910A.FUL (for  FULLBACK.SET/FULLBACK.CAT), you  delete
  1087.    the CE30910A.FUL  file and  make a  backup for  NEWSET.SET/NEWSET.CAT
  1088.    after this delete. Chances are, that the resulting file also has  the
  1089.    name  CE30910A.FUL.  Now  FULLBACK.CAT  and  NEWSET.CAT  both have an
  1090.    entry for CE30910A.FUL. NBS can detect this and will display up to  5
  1091.    CAT  files  that  point  to  the  same  file.  No automatic action is
  1092.    possible, because NBS  will not do  a deep examination  of the files.
  1093.    You must write them down and correct the error by hand.
  1094.  
  1095.  If  you  perform  a  regular  check  (/NBSCHK)  and clean all incorrect
  1096.  entries  (either  by  hand  or  automatically),  you  will  end  with a
  1097.  complete clean set of files. You  can run /NBSCHK as many times  as you
  1098.  like,  to  see  if  the  final  result  is clean. After that, perform a
  1099.  /NBSCHK once in a while to see if the files are still correct.
  1100.  
  1101.  
  1102.  4.1.5 Updating NBS.STA
  1103.  ───────────────────────────────────────────────────────────────────────
  1104.  NBS will maintain a file called NBS.STA. This file contains information
  1105.  about  the  last  execution of either NBS and Norton Backup, as well as
  1106.  the values for  the  CycleSetx parameters (the current tape to use) and
  1107.  the seconds  passed  since  the  last  cleaning operation of the backup
  1108.  device.
  1109.  
  1110.  The first time, there will be no NBS.STA. In this case, NBS will create
  1111.  the file (with default values)  from  scratch. All next times, NBS will
  1112.  change and update  the  file. For  example if you change CycleSet1 from
  1113.  FULLBACK.SET to FULL.SET, NBS  will  update the NBS.STA file itself and
  1114.  will reset all the counters involved.
  1115.  
  1116.  There are  2  specific  command-line  paramaters  that  can  be used to
  1117.  update the NBS.STA file (it  is  a  binary file, so you need to use NBS
  1118.  to do this job for you).
  1119.  
  1120.  /NBSCLN will  update  the number of seconds passed after the last clean
  1121.  action to a value  of 0. This comes in handy when you cleaned the drive
  1122.  inbetween and  without  NBS telling you so. After the clean action, you
  1123.  run NBS /NBSCLN only once and the counting starts over from scratch.
  1124.  
  1125.  /NBSCSx=y will  update the current tape-number to use for the CycleSetx
  1126.  to a value of y. If 'y'  is higher than the maximum number of tapes you
  1127.  allow on the CycleSetx option, NBS will abort.
  1128.  
  1129.  When you specify either /NBSCLN or /NBSCSx=y on the command-line, there
  1130.  will be  NO  call  to  Norton Backup (or the renamed version), nor will
  1131.  there be any extraction (and archiving) of files from the NBS.ZIP file.
  1132.  
  1133.  
  1134.  4.2 Command-line parameters
  1135.  ───────────────────────────────────────────────────────────────────────
  1136.  The general syntax  of a call  to NBS is  the same as  a call to Norton
  1137.  Backup but there are a few new parameters that will trigger NBS  itself
  1138.  without interfering with Norton Backup. These extra parameters are:
  1139.  
  1140.  /NBSFTM    You instruct NBS  that it is the first execution and  that a
  1141.             NBS.ZIP has to be created and is NOT already available;
  1142.  
  1143.  /NBSCHK    You   perform checking  of the  files in  the Norton  Backup
  1144.             data-directory. Norton Backup itself is NOT executed;
  1145.  
  1146.  /NBSCLN    Will  reset  the  clean-counter in NBS.ZIP to 0 seconds. Use
  1147.             this if you cleaned the drive in-between;
  1148.  
  1149.  /NBSCSx=y  Will reset the current  tape number in CycleSetx (where x is
  1150.             1 to 9) to  the  value  'y'. 'y'  can not be higher than the
  1151.             maximum number you allow on the CycleSetx option.
  1152.  
  1153.  Newer versions of NBS will have some extra options for certain  special
  1154.  functions (user requests). If they have to be interpreted by NBS,  they
  1155.  will always begin with /NBS......
  1156.  
  1157.  
  1158. │4.3 Format of the NBS.ZIP file
  1159. │───────────────────────────────────────────────────────────────────────
  1160. │NBS  will  store  all the Norton Backup related files into a PkWare ZIP
  1161. │archive,  either  with PKZIP.EXE/PKUNZIP.EXE  or  the  compatible clone
  1162. │you use.
  1163. │
  1164. │The  format of this NBS.ZIP file is somewhat special. If you use a good
  1165. │archive  view  program (archive-shell), you can see the internal format.
  1166. │This can also  be  viewed with PKUNZIP -v NBS.ZIP. The NBS.ZIP is build
  1167. │from a  large  number of  directories, all  with the extension .NBS and
  1168. │inside these  directories  are the files. For each and every SET, there
  1169. │is a  directory  inside  the  NBS.ZIP and all files that belong to this
  1170. │SET are stored under that directory, like this:
  1171. │
  1172. │FULLBACK.NBS\FULLBACK.SET
  1173. │FULLBACK.NBS\FULLBACK.SLT
  1174. │FULLBACK.NBS\FULLBACK.SAV
  1175. │FULLBACK.NBS\FULLBACK.CAT
  1176. │FULLBACK.NBS\CE32009A.FUL
  1177. │FULLBACK.NBS\CE32109A.INC
  1178. │FULLBACK.NBS\CE32109B.INC
  1179. │FULLBACK.NBS\CE32209A.INC
  1180. │
  1181. │There is one  special directory inside the NBS.ZIP file and this is the
  1182. │REMAINDR.NBS  directory. Inside THIS directory NBS will store all files
  1183. │that can not be  categorized. This will normally be the PROTECT.LST but
  1184. │it is also possible that INC/FUL/DIF files are stored overhere. In this
  1185. │case, these INC/FUL/DIF files  do not belong to any SET/CAT combination
  1186. │and are orphans. When you run  NBS /NBSCHK, NBS  will ask  you if these
  1187. │files have to  be  removed (after  NBS  has  checked AGAIN if these are
  1188. │actual orphan-files).
  1189. │
  1190. │Normally you will never detect these directories on your harddisk. NBS
  1191. │will temporary create them under its own temporary directory AFTER the
  1192. │Norton Backup  program has terminated and BEFORE NBS itself terminates.
  1193. │When NBS extracts sets, it does so WITHOUT creating the directory.
  1194. │
  1195. │
  1196. │4.4 Errors
  1197.  ───────────────────────────────────────────────────────────────────────
  1198.  All has been  done to keep  the number of  possible errors as  small as
  1199.  possible. Some errors have to do with incorrect options in NBS.INI  and
  1200.  are self-explaining.
  1201.  
  1202.  There is one specific error that needs manual care. If the NBS.ZIP file
  1203.  contains  duplicate file-names in different SET-directories, you have a
  1204.  small problem. The following sequence is suggested:
  1205.  
  1206.  - Locate  the  duplicate  names  (either from a verbose list of PKUNZIP
  1207.    that you can create with PKUNZIP -v NBS.ZIP);
  1208.  
  1209.  - Extract ALL files of the smallest of the two SET-directories with the
  1210.    PKUNZIP.EXE program (e.g.  PKUNZIP NBS.ZIP [directory]\*.*. Leave the
  1211.    other  SET  as  it  was. Extraction  has to be done inside the Norton
  1212.    Backup data-directory;
  1213.  
  1214.  - Delete  ALL  files of the previously extracted SET-directory from the
  1215.    NBS.ZIP file (e.g. PKZIP -d NBS.ZIP [directory]\*.*;
  1216.  
  1217.  - Delete  all *.INC/FUL/DIF files that came from NBS.ZIP (in the Norton
  1218.    Backup data-directory);
  1219.  
  1220.  - Extract  ALL remaining  files  from NBS.ZIP (inside the Norton Backup
  1221.    data-directory);
  1222.  
  1223.  - Rename NBS.ZIP to OLDNBS.ZIP;
  1224.  
  1225.  - Start Norton Backup (NOT THRU NBS);
  1226.  
  1227.  - Load the  SET  that you extracted the FIRST time (the smallest of the
  1228.    two, that doesn't have any INC/FUL/DIF files anymore);
  1229.  
  1230.  - Goto  RESTORE  and  CATALOG. Now REBUILD the catalogs from the backup
  1231.    medium (do  not  RETRIEVE, they  will get the same name as before and
  1232.    will ask for overwrite);
  1233.  
  1234.  - After all have been REBUILD, terminate Norton Backup;
  1235.  
  1236.  - Start  NBS  with  the  /NBSFTM switch to create a new (clean) NBS.ZIP
  1237.    file.
  1238.  
  1239.  There are  many  other ways you can use. The error will only happen when
  1240.  you tampered  with  the INC/FUL/DIF files. There  is  also a very small
  1241.  chance  that  you created this situation with NBS 1.01, but only if you
  1242.  frequently do backups for DIFFERENT sets on the same day;
  1243.  
  1244.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1245.  │   5   │ Version information and credits                             │
  1246.  └───────┴─────────────────────────────────────────────────────────────┘
  1247.  
  1248.  5.1 The BETA-team
  1249.  ───────────────────────────────────────────────────────────────────────
  1250.  Look into the file SUPPORT.NBS for a full list of all beta-testers  and
  1251.  support nodes.  Not all  beta-testers will  test this  program, because
  1252.  only a few of them own  their own copy of Norton Backup.  The remaining
  1253.  members will only distribute the NBS package.
  1254.  
  1255.  
  1256.  
  1257.  5.2 Credits
  1258.  ───────────────────────────────────────────────────────────────────────
  1259.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  1260.  BETA team):
  1261.  
  1262.  - Symantec Corporation for creating Norton Backup;
  1263.  
  1264.  - All   paying, registered   users. You   made it   possible to enhance
  1265.    NBS with nice features;
  1266.  
  1267.  - All users who did write me bug reports, suggestions and so on;
  1268.  
  1269.  
  1270.  
  1271.  5.3 Version history
  1272.  ───────────────────────────────────────────────────────────────────────
  1273.  ┌───────┬────────────────────────────┐
  1274.  │ 1.01  │ First version              │
  1275.  └───────┴────────────────────────────┘
  1276.   ■ First public version;
  1277.  
  1278.  
  1279.  ┌───────┬────────────────────────────┐
  1280.  │ 1.02  │ Maintenance release        │
  1281.  └───────┴────────────────────────────┘
  1282.   ■ Because  of  the  algorithm, NBS would leave too many obsolete files
  1283.     inside  the  NBS.ZIP. NBS  will  now  remove any extracted file from
  1284.     the  NBS.ZIP (before  calling Norton Backup) or will even delete the
  1285.     complete NBS.ZIP when ALL files are extracted;
  1286.  
  1287.   ■ Fixed  the  problem  of  creating  duplicate  INC/FUL/DIF  files for
  1288.     different  sets  when  done on the same day (and for the same drives
  1289.     and  with  the same option). NBS will fool Norton Backup with one or
  1290.     more  bogus-files so Norton Backup will select a new unique name for
  1291.     the new backup;
  1292.  
  1293.   ■ NBS  would  extract files from NBS.ZIP with the overwrite switch set
  1294.     to 'allow'. This  could  cause  data-lost  situations  (that easilly
  1295.     be recovered with Norton Backup). Overwriting is not allowed anymore
  1296.     and NBS  will  abort  if  duplicate files are extracted from NBS.ZIP
  1297.     (see chapter 4.4 for a description);
  1298.  
  1299.   ■ NBS would abort if no PROTECT.LST was created. This has been fixed;
  1300.  
  1301.   ■ NBS would  abort  if  you used the NBS.INI from the original archive
  1302.     and did not remove the options under [Registration];
  1303.  
  1304.   ■ NBS  could  not  be started with the name of a new SET. In this case,
  1305.     NBS  would  abort  and you had to call Norton Backup itself to first
  1306.     create  a  new  set. NBS  will  now continue without any SET and you
  1307.     are asked by Norton Backup if you want to create the new set;
  1308.  
  1309.   ■ Some cosmetic  changes to the layout of the screen and added an line
  1310.     that includes the time until the next clean (if set);
  1311.  
  1312.   ■ If  logging  is  set  to ON and the MergeNBackupLog option is set to
  1313.     TRUE  (or Y), NBS  will  obtain  the 'drive-active'  time  (for  the
  1314.     cleaning cyclus)  from  any  available  *.RPT file. If  such  a file
  1315.     is  not  available  (no  logging  by Norton Backup set by the user),
  1316.     NBS will calculate the 'drive-active' time as before;
  1317.  
  1318.  NBS is tested with PKWare PKZIP version 2.04g and Norton Backup 2.2.      ,
  1319.  
  1320.  
  1321.  5.4 Copyright, Trademarks
  1322.  ───────────────────────────────────────────────────────────────────────
  1323.  Norton Backup     is a trademark  of Symantec Corporation
  1324.  PKZIP and PKUNZIP are  trademarks of PKWare Inc.
  1325.  Windows           is a trademark  of The Microsoft Corporation
  1326.  Ms/DOS            is a trademark  of The Microsoft Corporation
  1327.  4Dos              is a trademark  of J.P. Software/R.C. Conn/T. Rawson
  1328.  
  1329.  NBS is written  in Borland Pascal 7.0, with help of the Turbo  Debugger
  1330.  3.0 and makes extensive use of Object Professional V 1.20.
  1331.  
  1332.  Borland Pascal      is a trademark  of Borland International
  1333.  Turbo Debugger      is a trademark  of Borland International
  1334.  Object Professional is a trademark  of TurboPower Inc.
  1335.  Asynch Professional is a trademark  of TurboPower Inc.
  1336.  
  1337.  [======================== END OF DOCUMENT ============================]
  1338.